Xbasic

A5_Get_Filter Function

Syntax

Filter_Expn as C = a5_get_filter(C default_filter [,C tables [,L use_genie [,L top_level [,C topparent_windowname [,C variable_list ]]]]])

Arguments

Filter_Expn

The resulting filter expression.

default_filter

The default filter expression to display in the dialog.

tables

Optional. Default = "". Controls whether external or local tables are shown. "" = Show local tables. Tables = List of tables to show.

use_genie

Optional. Default = .T.

top_level

Optional. Default = .T. .T. = Show top level tables of sets only. .F. = Show all tables.

topparent_windowname

Optional. Default = "". The name of the top parent window.

variable_list

Optional. Default = "".

Description

Prompts the user for a filter

Discussion

The A5_Get_Filter() function displays the Filter Builder and returns the specified filter expression.

Example

This example opens the Filter Builder with a default expression and returns the expression as modified by the user.

? a5_get_filter("lastname > 'm'","customer", .f.)
= "(lastname > 'm') .and. (firstname > 'a')"

Limitations

Desktop applications only.

See Also